home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / coord3.arc / CO-ORD3.DOC next >
Text File  |  1986-05-11  |  12KB  |  224 lines
  1.  
  2.  
  3.  
  4.         Skunkworks Learning Center
  5.         Spread the Knowledge...
  6.  
  7.         THE COORDINATOR   Version 1.03
  8.  
  9.     First, there was THE COORDINATOR Version 1.0; plot out screens using
  10.     ascii characters, color cursor and return coordinates of a cursor's
  11.     position.  Then, there was THE COORDINATOR Version 2.1 which supported
  12.     basically, the same functions as version 1 with a few additional
  13.     functions like the ability to save and reload color ascii screens.  Well,
  14.     here it is...version 1.03.  Why have we regressed in version numbers?  To
  15.     tell you the truth, the feedback indicated that the releases 1 and 2 were
  16.     considered to be "premature" releases, at best.  Well, we're not going to
  17.     deny our hastiness.  I personally apologize to those of you who spent 10+
  18.     minutes designing a screen only to have it "wiped out" by a simple error
  19.     which should have been "handled" rather than aborting the whole program.
  20.     For those of you, I am confident that you will find version 1.03 to your
  21.     liking.  I have included error handling routines for all correctable
  22.     errors.  Now that doesn't mean that you can't "lose" a screen, it just
  23.     means that if you do lose a screen, it's for good reason.
  24.  
  25.     This is not a highly-portable program.  It was written on and specifically
  26.     for the IBM PCjr.  It may run on other PC compatible machines that support
  27.     color graphics.  For you jr users, you must have 128k of memory and DOS
  28.     2.1.
  29.  
  30.     Please, for the good of this program, if you find severe errors or have
  31.     helpful comments/suggestions, leave a public message on the TC/PC users
  32.     group BBS at (612) 545-5014.
  33.  
  34.     The file called RELOAD.BAS is in BASIC source code and may be merged into
  35.     a program you design to be used to call up custom-made screens created
  36.     with THE COORDINATOR.  Please see the MERGE command in your BASIC
  37.     reference manual for details on how to use MERGE.
  38.  
  39.     This program is Public Domain.  Copying/Distributing is encouraged,
  40.     however, if you find the program to be useful, please send $20 to
  41.     your favorite charity.
  42.  
  43.  
  44.  
  45.  
  46.               THE COORDINATOR - Version 1.03 - Basic Instructions
  47.  
  48.      THE COORDINATOR uses the cursor control keys to move the cursor and
  49.      the function keys to perform various functions.  These functions are
  50.      described as follows:
  51.  
  52.              Fn1:    CLS     Clears the screen (except current position)
  53.            * Fn2:    CRD     Returns current cursor coordinates as
  54.                              * r,c where * is an indicator for tracking
  55.                              ease and r is the cursor's current row and
  56.                              c is the cursor's current column number.
  57.              Fn3:    TRL     Toggles the "Trail" on/off.  This is used to
  58.                              "draw" on the screen.
  59.              Fn4:    CRS     Changes the current cursor.  There are 20+
  60.                              choices.
  61.              Fn5:    N/A     This key was reserved for an upcoming
  62.                              function.
  63.           ** Fn6:    INP     Puts text/numerics on the screen.
  64.              Fn7:    SVE     Saves current screen to disk.
  65.              Fn8:    RLD     Reloads a previously-saved screen.
  66.              Fn9:    CLR     Changes the current cursor color.
  67.              Fn10:   END     Exits THE COORDINATOR. Current screen is cleared
  68.  
  69.      *NOTE:  If you return the coordinates of a cursor that is on line
  70.      number 1, line number 22, or is too close to the right edge of the
  71.      screen, the coordinates are displayed in another position.
  72.      Regardless of where the coordinates are displayed, keep in mind that
  73.      they are the correct coordinates of the current cursor.
  74.  
  75.      **NOTE:  When Fn6 is pressed, a prompt "->" will be displayed at the
  76.      current cursor position.  The actual prompt takes up two cursor
  77.      positions, but once the input is terminated with an enter, the string
  78.      will begin where the prompt was displayed.  Play with this a couple
  79.      of times and you will get the idea of how it works.
  80.  
  81.  
  82.  
  83.      SAVING/RELOADING SCREENS
  84.  
  85.      When you press Fn7 (SVE) a prompt will be displayed on the top left
  86.      portion of the screen for FILENAME.  Enter in a legal filename but
  87.      remember: DON'T USE BACKSPACE.  Especially if there are any
  88.      charaters on the first line of the screen.  Using a backspace will
  89.      discolor the entire line as well as shift the line one space left for
  90.      every backspace pressed.  This rule is void if there is nothing on line
  91.      one.
  92.  
  93.      THE COORDINATOR reads every space on the screen, whether you use
  94.      every space or not so it takes a little longer to save a screen than
  95.      to display which does not use every space on the screen.
  96.  
  97.      When you press Fn8 (RLD) and answer the FILENAME? prompt with a valid
  98.      filename, the previously saved screen is displayed and a tone sounded
  99.      upon completion.  Press an arrow key (up or down is best) and you will
  100.      see the cursor appear in column number 79.  Normally, you cannot place
  101.      the cursor in column 79.  If the TRAIL toggle was on, it is now off.
  102.      DON'T TURN IT ON until you are out of column 79.  Once you are out of
  103.      column 79, you cannot get back into it without using the RELOAD function.
  104.      The cursor is placed in column 79 so that you will know where the cursor
  105.      is after a RELOAD.  This is preferred over the previous releases where
  106.      the cursor appeare in the middle of the screen where it could possibly
  107.      "delete" ascii characters that may reside at that position.
  108.  
  109.       NOTE:  When entering a response to the prompt; FILENAME?, use a filename
  110.              that is no longer than 8 characters in length.  The extension
  111.              .CRD will be added to all saved screens.  DO NOT specify your own
  112.              extension.
  113.  
  114.  
  115.      ERRORS      We all hate 'em
  116.  
  117.      There are only a few probable errors usually encountered in this
  118.      program.  The most common being:  Trying to load a non-existant file.
  119.      When this error is encountered, "CAN'T FIND FILE" is displayed.
  120.  
  121.      Other errors, such as Disk Full, Redo From Start, Write Protected,
  122.      etc are common user errors that used to be devistating to a screen you've
  123.      been working on.  Well, those errors are now handled quite well by THE
  124.      COORDINATOR.  The error messages displayed by THE COORDINATOR are:
  125.  
  126.           DISK FULL!        The disk is full, the file is closed and
  127.                             deleted by THE COORDINATOR. The screen will not
  128.                             be cleared. Insert another disk and save the
  129.                             image again.
  130.  
  131.           CAN'T FIND FILE   The RELOAD function was called and a non-
  132.                             existant filename was specified.  Repeat the
  133.                             RELOAD function and specify a valid filename.
  134.  
  135.           DISK I/O ERROR!   The RELOAD or SAVE functions were called and
  136.                             one of the following conditions exists:
  137.                             Disk Not Ready, Device I/O Error, Disk Not Ready,
  138.                             or Disk Write Protect.  The screen will not be
  139.                             cleared.  Check your disk drive and repeat the
  140.                             function called.
  141.  
  142.           BAD FILE NAME!    The RELOAD or SAVE functions were called and one
  143.                             of the following conditions exists:
  144.                             Bad File Number or Bad File Name.  The screen will
  145.                             not be cleared.  Repeat the called function and
  146.                             specify a valid file name.
  147.  
  148.           TOO MANY FILES!   The RELOAD or SAVE functions were called and one
  149.                             of the following conditions exists:
  150.                             Too Many Files.  This is an erroneous message
  151.                             which is returned when, in response to FILENAME?,
  152.                             a carriage return is entered instead of a valid
  153.                             filename.  This is a good way to abort the RELOAD
  154.                             or SAVE functions from the FILENAME? prompt.
  155.  
  156.      UNRECOVERABLE ERROR... An error condition which prevents program
  157.                             execution exists.  The screen is cleared and the
  158.                             program is aborted.  The error code is returned on
  159.                             the display.  Make a note of the code and leave a
  160.                             public message on the TC/PC users group BBS
  161.                             describing the conditions which proceeded the
  162.                             Unrecoverable Error.
  163.  
  164.      Well, as always, we realize that there is always potential for errors
  165.      which may interrupt normal operation.  These errors can be corrected
  166.      only if you the user notifies us.  We realize the aggravation caused by
  167.      the loss of data.  We'll help to prevent it if you let us.
  168.  
  169.  
  170.      NOTES AND HELPFUL HINTS
  171.  
  172.      You will find, upon starting THE COORDINATOR, a prompt asking for 40 or
  173.      80 character width.  Unless you intend to use only 40 character mode,
  174.      ALWAYS enter 80.  If you're using a PC Compatible with color graphics,
  175.      you will always, of course enter 80.
  176.  
  177.      Here's something helpful:  Creat a couple of "toggle" screens.  Do this
  178.      by following these instructions:
  179.  
  180.      Start up THE COORDINATOR by typing "GO" at the DOS prompt.  Enter 40 in
  181.      response to the 40/80 character prompt.  Creat a simple screen.  It
  182.      doesn't even have to contain anything.  Then, do a Fn7 (SVE) and call
  183.      this file 40CHAR.  Then, exit THE COORDINATOR and restart.  This time,
  184.      enter 80 to the 40/80 character prompt.  Do the same here only call the
  185.      file 80CHAR.
  186.  
  187.      Now, regarless of the character width mode you're in, you can toggle back
  188.      and forth between them by using Fn8 (RLD) and responding to FILENAME?
  189.      with 40CHAR or 80CHAR.  If you've actually saved something to either of
  190.      these two files, you can use Fn1 (CLS) to clear the screen and begin
  191.      drawing from scratch.  But remember, you've used RELOAD so the cursor
  192.      will appear in the 79th or 39th column (depending on width mode) when you
  193.      press an arrow key.  Just don't turn the TRAIL on until you've left that
  194.      column or you won't be able to get back there to erase it.
  195.  
  196.  
  197.      ABOUT US:
  198.  
  199.      Skunkworks and Skunkworks Learning Center are trademarks of people
  200.      who want to learn and do so by brute studying.  We believe that
  201.      knowledge gained should be knowledge spread.  The more "aware" a
  202.      person would be with that knowledge.  A knowledge that will lead to
  203.      more technically oriented people and in turn to higher technology.
  204.      So...SPREAD THE KNOWLEDGE! (SK).
  205.  
  206.      Please help the Skunkworks Learning Center in progressing by leaving
  207.      public messages addressed to Skunkworks on any Twin Cities area Fido
  208.      BBS or specifically, the TC/PC Users Group BBS. We are always seeking
  209.      technically oriented computer users who have the desire to learn.
  210.  
  211.  
  212.      John M. Parlin
  213.      Author of THE COORDINATOR
  214.      and Founder of SKunkworks Learning Center
  215.  
  216.  
  217.      SPREAD THE KNOWLEDGE!
  218. and in turn to higher technology.
  219.      So...SPREAD THE KNOWLEDGE! (SK).
  220.  
  221.      Please help the Skunkworks Learning Center in progressing by leaving
  222.      public messages addressed to Skunkworks on any Twin Cities area Fido
  223.      BBS or specifically, the TC/PC Users Group BBS. We are always seeking
  224.      technically oriented computer users who have the desi